Add GtkAboutDialog and GtkFileChooserButton

Sun Oct 24 02:54:36 2004  Jonathan Blandford  <jrb@redhat.com>

        * gtk/gtk.types: Add GtkAboutDialog and GtkFileChooserButton

        * gtk/tmpl/GtkFileChooserButton.sgml: Write docs

        * gtk/tmpl/GtkListStore.sgml: Update performance comment now that
        we use GSequence.

        * gtk/visual_index.xml: Fix up a couple of errors.

        * gtk/images/*png: update

Sun Oct 24 02:56:43 2004  Jonathan Blandford  <jrb@redhat.com>

        * docs/tools/widgets.c: Update GtkFileChooserButton doc shot.

diff --git a/ChangeLog b/ChangeLog
index 73774f6f0d59367cd2f5bca8810990b1129da055..2fa6c7c9077c5cb32c7b227bd58cf0839b40655d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Sun Oct 24 02:56:43 2004  Jonathan Blandford  <jrb@redhat.com>
+
+       * docs/tools/widgets.c: Update GtkFileChooserButton doc shot.
+
 2004-10-24  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkicontheme.c: Use the new g_key_file api in GLib.

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 73774f6f0d59367cd2f5bca8810990b1129da055..2fa6c7c9077c5cb32c7b227bd58cf0839b40655d 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,7 @@
+Sun Oct 24 02:56:43 2004  Jonathan Blandford  <jrb@redhat.com>
+
+       * docs/tools/widgets.c: Update GtkFileChooserButton doc shot.
+
 2004-10-24  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkicontheme.c: Use the new g_key_file api in GLib.

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 73774f6f0d59367cd2f5bca8810990b1129da055..2fa6c7c9077c5cb32c7b227bd58cf0839b40655d 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,7 @@
+Sun Oct 24 02:56:43 2004  Jonathan Blandford  <jrb@redhat.com>
+
+       * docs/tools/widgets.c: Update GtkFileChooserButton doc shot.
+
 2004-10-24  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkicontheme.c: Use the new g_key_file api in GLib.

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 73774f6f0d59367cd2f5bca8810990b1129da055..2fa6c7c9077c5cb32c7b227bd58cf0839b40655d 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,7 @@
+Sun Oct 24 02:56:43 2004  Jonathan Blandford  <jrb@redhat.com>
+
+       * docs/tools/widgets.c: Update GtkFileChooserButton doc shot.
+
 2004-10-24  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkicontheme.c: Use the new g_key_file api in GLib.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 5f6ca493594eebea81e7a294514b965a9b307282..4e95e434ccbad3d371788c1d7cbe36218abac0ba 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,16 @@
+Sun Oct 24 02:54:36 2004  Jonathan Blandford  <jrb@redhat.com>
+
+       * gtk/gtk.types: Add GtkAboutDialog and GtkFileChooserButton
+
+       * gtk/tmpl/GtkFileChooserButton.sgml: Write docs
+
+       * gtk/tmpl/GtkListStore.sgml: Update performance comment now that
+       we use GSequence.
+
+       * gtk/visual_index.xml: Fix up a couple of errors.
+
+       * gtk/images/*png: update
+
 2004-10-22  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtk-sections.txt: Add new DND functions.

diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 57ab11c30c69dd98e985673bfedc8ba289dd5900..822c05cf210fdc05cb34d1349f13fbcf06cf7bf4 100644 (file)
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -203,33 +203,34 @@ HTML_IMAGES = \
        $(top_srcdir)/gtk/stock-icons/stock_media_record_24.png         \
        $(top_srcdir)/gtk/stock-icons/stock_media_rewind_24.png         \
        $(top_srcdir)/gtk/stock-icons/stock_media_stop_24.png           \
-       $(srcdir)/images/font-button.png                                \
+       $(srcdir)/images/accel-label.png                                \
        $(srcdir)/images/button.png                                     \
        $(srcdir)/images/check-button.png                               \
        $(srcdir)/images/color-button.png                               \
        $(srcdir)/images/combo-box-entry.png                            \
        $(srcdir)/images/entry.png                                      \
+       $(srcdir)/images/file-button.png                                \
+       $(srcdir)/images/font-button.png                                \
        $(srcdir)/images/frame.png                                      \
+       $(srcdir)/images/icon-view.png                                  \
+       $(srcdir)/images/image.png                                      \
        $(srcdir)/images/label.png                                      \
        $(srcdir)/images/list-and-tree.png                              \
-       $(srcdir)/images/multiline-text.png                             \
-       $(srcdir)/images/panes.png                                      \
-       $(srcdir)/images/radio-group.png                                \
-       $(srcdir)/images/separator.png                                  \
-       $(srcdir)/images/toggle-button.png                              \
-       $(srcdir)/images/window.png                                     \
-       $(srcdir)/images/accel-label.png                                \
-       $(srcdir)/images/file-button.png                                \
-       $(srcdir)/images/icon-view.png                                  \
-       $(srcdir)/images/toolbar.png                                    \
        $(srcdir)/images/menubar.png                                    \
+       $(srcdir)/images/messagedialog.png                              \
+       $(srcdir)/images/multiline-text.png                             \
        $(srcdir)/images/notebook.png                                   \
+       $(srcdir)/images/panes.png                                      \
        $(srcdir)/images/progressbar.png                                \
+       $(srcdir)/images/radio-group.png                                \
+       $(srcdir)/images/scales.png                                     \
        $(srcdir)/images/scrolledwindow.png                             \
+       $(srcdir)/images/separator.png                                  \
        $(srcdir)/images/spinbutton.png                                 \
        $(srcdir)/images/statusbar.png                                  \
-       $(srcdir)/images/image.png                                      \
-       $(srcdir)/images/messagedialog.png
+       $(srcdir)/images/toggle-button.png                              \
+       $(srcdir)/images/toolbar.png                                    \
+       $(srcdir)/images/window.png
 
 # Extra options to supply to gtkdoc-fixref
 FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html

diff --git a/docs/reference/gtk/gtk.types b/docs/reference/gtk/gtk.types
index 0352e8eaf0c771bfe5bf5d19bee0f871bb8de2ed..d983e187254334eafb44ccfc3b929fb4aaa49e43 100644 (file)
--- a/docs/reference/gtk/gtk.types
+++ b/docs/reference/gtk/gtk.types
@@ -1,5 +1,6 @@
 #include <gtk/gtk.h>
 
+gtk_about_dialog_get_type
 gtk_accel_group_get_type
 gtk_accel_map_get_type
 gtk_accel_label_get_type
@@ -40,6 +41,7 @@ gtk_entry_get_type
 gtk_event_box_get_type
 gtk_expander_get_type
 gtk_file_chooser_get_type
+gtk_file_chooser_button_get_type
 gtk_file_chooser_dialog_get_type
 gtk_file_chooser_widget_get_type
 gtk_file_filter_get_type

diff --git a/docs/reference/gtk/images/accel-label.png b/docs/reference/gtk/images/accel-label.png
index 2e7d315d948337694416d590fe9f7ba76df9fb81..aa928778197417786578914b0e2c87d31313f8f6 100644 (file)
Binary files a/docs/reference/gtk/images/accel-label.png and b/docs/reference/gtk/images/accel-label.png differ

diff --git a/docs/reference/gtk/images/button.png b/docs/reference/gtk/images/button.png
index 76e2f68f3a28ba64bb6f3d3a483f8de83948e8b0..b33190f6f6478ec2c98352f6a6f99f1cf01c7674 100644 (file)
Binary files a/docs/reference/gtk/images/button.png and b/docs/reference/gtk/images/button.png differ

diff --git a/docs/reference/gtk/images/check-button.png b/docs/reference/gtk/images/check-button.png
index a42487fc2e3705006c2efc460ae956bb87a6d03d..5c38179d37cdfc16ab90462ed5b29d408f99ad57 100644 (file)
Binary files a/docs/reference/gtk/images/check-button.png and b/docs/reference/gtk/images/check-button.png differ

diff --git a/docs/reference/gtk/images/color-button.png b/docs/reference/gtk/images/color-button.png
index e48a5771a8275813da2bda963e692cea67162776..256c8d9a243bfa192d4f1c13728b5717b99f5008 100644 (file)
Binary files a/docs/reference/gtk/images/color-button.png and b/docs/reference/gtk/images/color-button.png differ

diff --git a/docs/reference/gtk/images/combo-box-entry.png b/docs/reference/gtk/images/combo-box-entry.png
index edaacbf5daed83539d687e11de8335b1f9e1a4a8..d5f216fd3524b7dc282531efb8cc08e8be867398 100644 (file)
Binary files a/docs/reference/gtk/images/combo-box-entry.png and b/docs/reference/gtk/images/combo-box-entry.png differ

diff --git a/docs/reference/gtk/images/entry.png b/docs/reference/gtk/images/entry.png
index 708de64975c1d72c5d70cfef9377c9e3026c6f1e..eebca164e4dffd30d4960dd2a585c4c7fc99f530 100644 (file)
Binary files a/docs/reference/gtk/images/entry.png and b/docs/reference/gtk/images/entry.png differ

diff --git a/docs/reference/gtk/images/file-button.png b/docs/reference/gtk/images/file-button.png
index d0dc0d96982c8517a7c96d4a25bd850c9e2332bf..4f40e8732b3ffd9650f86fd2c31b47fe48f2968e 100644 (file)
Binary files a/docs/reference/gtk/images/file-button.png and b/docs/reference/gtk/images/file-button.png differ

diff --git a/docs/reference/gtk/images/font-button.png b/docs/reference/gtk/images/font-button.png
index e8ae8ad93e85307613cb29858b8025c99c3a3fa8..43e6aa5773827864f42bb9354221d5a8c75a470f 100644 (file)
Binary files a/docs/reference/gtk/images/font-button.png and b/docs/reference/gtk/images/font-button.png differ

diff --git a/docs/reference/gtk/images/frame.png b/docs/reference/gtk/images/frame.png
index e67db869edcec03fb85623b1456ee82174ff43ab..5a91f7e6dd2ae8a6bd527496d3a86ebe8683e840 100644 (file)
Binary files a/docs/reference/gtk/images/frame.png and b/docs/reference/gtk/images/frame.png differ

diff --git a/docs/reference/gtk/images/icon-view.png b/docs/reference/gtk/images/icon-view.png
index 93eaff0863311ba62c4771ff58d27dec56122d44..49038c5df2d932de23d291ecc00837e4746ba79f 100644 (file)
Binary files a/docs/reference/gtk/images/icon-view.png and b/docs/reference/gtk/images/icon-view.png differ

diff --git a/docs/reference/gtk/images/image.png b/docs/reference/gtk/images/image.png
index 3200e6bace115290cdce969fe84debec1a26ec29..f611aba507635d9ea1249bf82645081669110565 100644 (file)
Binary files a/docs/reference/gtk/images/image.png and b/docs/reference/gtk/images/image.png differ

diff --git a/docs/reference/gtk/images/label.png b/docs/reference/gtk/images/label.png
index b3cc70bf57aa80da049bdae4df8143223ce60707..c57ee62f6fcb5b895510aec27e57715c879a866e 100644 (file)
Binary files a/docs/reference/gtk/images/label.png and b/docs/reference/gtk/images/label.png differ

diff --git a/docs/reference/gtk/images/list-and-tree.png b/docs/reference/gtk/images/list-and-tree.png
index cd4831df0ca08c62a1569799052d96e5d5f27a38..fa720d8144bf37a2adc958ea049ad45ef62d0102 100644 (file)
Binary files a/docs/reference/gtk/images/list-and-tree.png and b/docs/reference/gtk/images/list-and-tree.png differ

diff --git a/docs/reference/gtk/images/menubar.png b/docs/reference/gtk/images/menubar.png
index 51f0f06a57f692c71bd22bd7cef5f07bccf643c0..3e2fcd5a57666b056a69e20790efeff4295adb41 100644 (file)
Binary files a/docs/reference/gtk/images/menubar.png and b/docs/reference/gtk/images/menubar.png differ

diff --git a/docs/reference/gtk/images/messagedialog.png b/docs/reference/gtk/images/messagedialog.png
index 35c5f11731a2fba7dc85fd45226228a0cb89f260..61197ba4d09e509a00b900a683bd2f2027b93ac7 100644 (file)
Binary files a/docs/reference/gtk/images/messagedialog.png and b/docs/reference/gtk/images/messagedialog.png differ

diff --git a/docs/reference/gtk/images/multiline-text.png b/docs/reference/gtk/images/multiline-text.png
index 8a0811abb22797ba963662c0cc08b2701524ee9b..d2f3d592f1695c59bee5bf4d6231527847bc3490 100644 (file)
Binary files a/docs/reference/gtk/images/multiline-text.png and b/docs/reference/gtk/images/multiline-text.png differ

diff --git a/docs/reference/gtk/images/notebook.png b/docs/reference/gtk/images/notebook.png
index 7c562e4db00935936d897a9c77cb59ef436a94af..21bdb42f840405494a37fe41916c5b00a7407bb0 100644 (file)
Binary files a/docs/reference/gtk/images/notebook.png and b/docs/reference/gtk/images/notebook.png differ

diff --git a/docs/reference/gtk/images/panes.png b/docs/reference/gtk/images/panes.png
index 4214d9c615b29e9508c1e5b6e011e72143897f9e..5132d4790b1ee7f11a0b7b5e5d52fcb1625249a9 100644 (file)
Binary files a/docs/reference/gtk/images/panes.png and b/docs/reference/gtk/images/panes.png differ

diff --git a/docs/reference/gtk/images/progressbar.png b/docs/reference/gtk/images/progressbar.png
index abe116a187b236f69bd0991df3ff9c642b4d7a88..21e4ed58e3b961c8ddc7cddcf9a5aef214b53cce 100644 (file)
Binary files a/docs/reference/gtk/images/progressbar.png and b/docs/reference/gtk/images/progressbar.png differ

diff --git a/docs/reference/gtk/images/radio-group.png b/docs/reference/gtk/images/radio-group.png
index 87200d0f5ba3760e9191410ebc83530f088ed771..94552e0c046bff48f9d383e5155b52c270a78cd9 100644 (file)
Binary files a/docs/reference/gtk/images/radio-group.png and b/docs/reference/gtk/images/radio-group.png differ

diff --git a/docs/reference/gtk/images/scales.png b/docs/reference/gtk/images/scales.png
index 3a54373499e9a12ac66809e6d8dc4b4a1a7ec33b..342061863e2c5a48eb8dc9d3c34d71d845634181 100644 (file)
Binary files a/docs/reference/gtk/images/scales.png and b/docs/reference/gtk/images/scales.png differ

diff --git a/docs/reference/gtk/images/scrolledwindow.png b/docs/reference/gtk/images/scrolledwindow.png
index b19f54b420070833846d7a543ec94ab991b33669..fa95d826ec81e95df9281e07e8ff386559f2ad9b 100644 (file)
Binary files a/docs/reference/gtk/images/scrolledwindow.png and b/docs/reference/gtk/images/scrolledwindow.png differ

diff --git a/docs/reference/gtk/images/separator.png b/docs/reference/gtk/images/separator.png
index d769bb53546885749672a1ee873123f04ecf63cc..4e7f74ec6a8973d45365f3e4eb0f7b389798ff13 100644 (file)
Binary files a/docs/reference/gtk/images/separator.png and b/docs/reference/gtk/images/separator.png differ

diff --git a/docs/reference/gtk/images/spinbutton.png b/docs/reference/gtk/images/spinbutton.png
index 0f287d85e03157961b0e723faccefdabfae3da9a..fb0bd45baf889946c9273d8eb1928880b8f193c2 100644 (file)
Binary files a/docs/reference/gtk/images/spinbutton.png and b/docs/reference/gtk/images/spinbutton.png differ

diff --git a/docs/reference/gtk/images/statusbar.png b/docs/reference/gtk/images/statusbar.png
index c4be9639ec6edaea86c731af25520e189845f63b..e257828d88ebe2128a0b689bb9518d2909d785b4 100644 (file)
Binary files a/docs/reference/gtk/images/statusbar.png and b/docs/reference/gtk/images/statusbar.png differ

diff --git a/docs/reference/gtk/images/toggle-button.png b/docs/reference/gtk/images/toggle-button.png
index a10fbd4e200c1ae5c5178d80393dbbdf26d95d39..8ed666b7002c97038a009039c3b94d07a69b73a8 100644 (file)
Binary files a/docs/reference/gtk/images/toggle-button.png and b/docs/reference/gtk/images/toggle-button.png differ

diff --git a/docs/reference/gtk/images/toolbar.png b/docs/reference/gtk/images/toolbar.png
index 55b11678d5adb499e4b3707f870330d929017705..d5ae5806f264dc72b1eef5c1ff86f26604d88ae6 100644 (file)
Binary files a/docs/reference/gtk/images/toolbar.png and b/docs/reference/gtk/images/toolbar.png differ

diff --git a/docs/reference/gtk/images/window.png b/docs/reference/gtk/images/window.png
index a28c8dc584f6d462e78a096ff79eee3870eaf9bb..fee6dccfef5747d01a4298c77d1f2cdf08ddd97a 100644 (file)
Binary files a/docs/reference/gtk/images/window.png and b/docs/reference/gtk/images/window.png differ

diff --git a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
index f0952f750dce3e8a361765140b24904c92c2592f..1f7dd84dc94721228224692bc01cbbd4233a205e 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
@@ -31,7 +31,71 @@ The <structname>GtkAboutDialog</structname> struct contains
 only private fields and should not be directly accessed.
 </para>
 
-@parent_instance: 
+
+<!-- ##### ARG GtkAboutDialog:artists ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:authors ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:comments ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:copyright ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:documenters ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:license ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:logo ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:translator-credits ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:version ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:website ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:website-label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAboutDialog:link-color ##### -->
+<para>
+
+</para>
 
 <!-- ##### FUNCTION gtk_about_dialog_new ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkdnd.sgml b/docs/reference/gtk/tmpl/gtkdnd.sgml
index c4793eb0f9072a91a0e4ba9d216799c040428b1b..4d8ba07d9c9bfaf939e9097db23f393289b9c251 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkdnd.sgml
+++ b/docs/reference/gtk/tmpl/gtkdnd.sgml
@@ -145,6 +145,22 @@ notification of drags.
 @widget: 
 
 
+<!-- ##### FUNCTION gtk_drag_dest_add_image_targets ##### -->
+<para>
+
+</para>
+
+@widget: 
+
+
+<!-- ##### FUNCTION gtk_drag_dest_add_uri_targets ##### -->
+<para>
+
+</para>
+
+@widget: 
+
+
 <!-- ##### FUNCTION gtk_drag_finish ##### -->
 <para>
 Informs the drag source that the drop is finished, and

diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 296c55f0b5098ef47c95d8a8155154879506bbb7..1602106a302a26f5b725955d1b2b2631b248a9f5 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -7,12 +7,12 @@ File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog
 <!-- ##### SECTION Long_Description ##### -->
     <para>
       #GtkFileChooser is an interface that can be implemented by file
-      selection widgets.  In GTK+, the main objects that implement
-      this interface are #GtkFileChooserWidget and
-      #GtkFileChooserDialog.  You do not need to write an object that
-      implements the #GtkFileChooser interface unless you are trying
-      to adapt an existing file selector to expose a standard
-      programming interface.
+      selection widgets.  In GTK+, the main objects that implement this
+      interface are #GtkFileChooserWidget, #GtkFileChooserDialog, and
+      #GtkFileChooserButton.  You do not need to write an object that
+      implements the #GtkFileChooser interface unless you are trying to
+      adapt an existing file selector to expose a standard programming
+      interface.
     </para>
 
     <refsect2 id="gtkfilechooser-encodings">
@@ -365,7 +365,7 @@ class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
 
 <!-- ##### SECTION See_Also ##### -->
     <para>
-      #GtkFileChooserDialog, #GtkFileChooserWidget
+      #GtkFileChooserDialog, #GtkFileChooserWidget, #GtkFileChooserButton
     </para>
 
 <!-- ##### STRUCT GtkFileChooser ##### -->

diff --git a/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml b/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
index 3ba80b506f491f7716f7dec9586f74aabdc184c6..09c476c01c781bc55fb78b98154bfe2e7f22e300 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
@@ -6,19 +6,90 @@ A button to launch a file selection dialog
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+The #GtkFileChooserButton is a widget that lets the user select a
+file.  It implements the #GtkFileChooser interface.  Visually, it is a
+file name with a button to bring up a #GtkFileChooserDialog.
+The user can then use that dialog to change the file associated with
+that button.  This widget does not support setting the "select-multiple"
+property to %TRUE.
+</para>
+
+<example>
+<title>Create a button to let the user select a file in /etc</title>
+<programlisting>
+{
+  GtkWidget *button;
+
+  button = gtk_file_chooser_button_new (_("Select a file"));
+  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
+                                       "/etc");
+}
+</programlisting>
+</example>
+
+<para>
+The #GtkFileChooserButton supports all four #GtkFileChooserAction<!--
+-->s that the #GtkFileChooser supports.  Two of the actions,
+%GTK_FILE_CHOOSER_ACTION_SAVE and
+%GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER, give the button the appearance
+of an entry next to a button.  The user can type the name of a file in
+this entry, and it will complete as it types.  The other two actions,
+%GTK_FILE_CHOOSER_ACTION_OPEN and
+%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER, make the #GtkFileChooserAction
+look like a #GtkButton.
+</para>
 
+<example>
+<title>Using GtkFileChooserButton in save mode</title>
+<programlisting>
+{
+  GtkWidget *button;
+
+  button = gtk_file_chooser_button_new (_("Save as..."));
+  gtk_file_chooser_set_action (GTK_FILE_CHOOSER (button),
+                               GTK_FILE_CHOOSER_ACTION_SAVE);
+  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER_BUTTON (button),
+                                       DEFAULT_SAVE_DIRECTORY);
+}
+</programlisting>
+</example>
+
+<important>
+<para>
+The #GtkFileChooserButton will ellipsize the label while in Open mode,
+and thus will thus request little horizontal space.  To give the dialog
+more space, you should call gtk_widget_size_request(), or pack it in
+such a way that other interface elements give space to the widget.
 </para>
+</important>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkFileChooserDialog
 </para>
 
 <!-- ##### STRUCT GtkFileChooserButton ##### -->
 <para>
+This should not be accessed directly.  Use the accessor functions below.
+</para>
+
+
+<!-- ##### ARG GtkFileChooserButton:active ##### -->
+<para>
+%TRUE, if the #GtkFileChooserDialog associated with the button has been
+made visible.  This can also be set by the application, though it is
+rarely useful to do so.
+</para>
 
+<!-- ##### ARG GtkFileChooserButton:dialog ##### -->
+<para>
+Instance of the #GtkFileChooserDialog associated with the button.
 </para>
 
+<!-- ##### ARG GtkFileChooserButton:title ##### -->
+<para>
+Title to put on the #GtkFileChooserDialog associated with the button.
+</para>
 
 <!-- ##### FUNCTION gtk_file_chooser_button_new ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkliststore.sgml b/docs/reference/gtk/tmpl/gtkliststore.sgml
index fbe5b3596abf68e7b4cc3f8f61327ea42d070bb5..229f66911a03f6e16253b9e6958936ef10202130 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkliststore.sgml
+++ b/docs/reference/gtk/tmpl/gtkliststore.sgml
@@ -83,12 +83,13 @@ enum {
 <refsect2>
 <title>Performance Considerations</title>
 <para>
-Internally, the #GtkListStore is implemented with a linked list with a
-tail pointer.  As a result, it is fast at data insertion and deletion,
-and not as fast at random data access.  The #GtkListStore sets the
-#GTK_TREE_MODEL_ITERS_PERSIST flag, which means that #GtkTreeIter<!--
--->s can be cached while the row exists.  Thus, if access to a
-particular row is needed often, it is worth keeping the iter around.
+Internally, the #GtkListStore was implemented with a linked list with a
+tail pointer prior to GTK+ 2.6.  As a result, it was fast at data
+insertion and deletion, and not fast at random data access.  The
+#GtkListStore sets the #GTK_TREE_MODEL_ITERS_PERSIST flag, which means
+that #GtkTreeIter<!-- -->s can be cached while the row exists.  Thus, if
+access to a particular row is needed often and your code is expected to
+run on older versions of GTK+, it is worth keeping the iter around.
 </para>
 </refsect2>
 

diff --git a/docs/reference/gtk/tmpl/gtkmain.sgml b/docs/reference/gtk/tmpl/gtkmain.sgml
index bdd307e177816f2bb7367320a13559c6410c10c0..fd1281787b72cf0ea5b1838c01be6d3bd932a60b 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkmain.sgml
+++ b/docs/reference/gtk/tmpl/gtkmain.sgml
@@ -136,6 +136,29 @@ functions such as g_signal_connect().
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_init_with_args ##### -->
+<para>
+
+</para>
+
+@argc: 
+@argv: 
+@parameter_string: 
+@entries: 
+@translation_domain: 
+@error: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_get_option_group ##### -->
+<para>
+
+</para>
+
+@open_default_display: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_exit ##### -->
 <para>
 Terminates the program and returns the given exit code to the caller. 

diff --git a/docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml b/docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml
index e153a3ee4f658f642de255be3fbbb2fee4895389..80d523f8ce49c19291c275be753e62478c11eb11 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml
@@ -90,3 +90,14 @@ A GtkToolItem containing a button with an additional dropdown menu
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_menu_tool_button_set_arrow_tooltip ##### -->
+<para>
+
+</para>
+
+@button: 
+@tooltips: 
+@tip_text: 
+@tip_private: 
+
+

diff --git a/docs/reference/gtk/tmpl/gtkselection.sgml b/docs/reference/gtk/tmpl/gtkselection.sgml
index 9982b574c9c0a156069e5a3a0173d2e4058444a1..59357ef1ea2bb0257af4fd52895b2d7ffbe00170 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkselection.sgml
+++ b/docs/reference/gtk/tmpl/gtkselection.sgml
@@ -134,6 +134,26 @@ Adds a table of #GtkTargetEntry into a target list.
 </para>
 
 @list: 
+@info: 
+
+
+<!-- ##### FUNCTION gtk_target_list_add_image_targets ##### -->
+<para>
+
+</para>
+
+@list: 
+@info: 
+@writable: 
+
+
+<!-- ##### FUNCTION gtk_target_list_add_uri_targets ##### -->
+<para>
+
+</para>
+
+@list: 
+@info: 
 
 
 <!-- ##### FUNCTION gtk_target_list_remove ##### -->
@@ -261,6 +281,44 @@ Zero-terminates the stored data.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_selection_data_set_pixbuf ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@pixbuf: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_get_pixbuf ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_set_uris ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@uris: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_get_uris ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_selection_data_get_targets ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtktextbuffer.sgml b/docs/reference/gtk/tmpl/gtktextbuffer.sgml
index fcd641f8a9f4b1516e701ad968516b8c50369292..a5a87d645cac887119db4596b6462796ef48e218 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktextbuffer.sgml
+++ b/docs/reference/gtk/tmpl/gtktextbuffer.sgml
@@ -295,6 +295,18 @@ types related to the text widget and how they work together.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_text_buffer_backspace ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@iter: 
+@interactive: 
+@default_editable: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_text_buffer_set_text ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtktoolitem.sgml b/docs/reference/gtk/tmpl/gtktoolitem.sgml
index 125806ae1242ccd36090830ef9c9ad1ee7e324cf..aa5bc95170409898bce96d2c36e446f670cf63b8 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktoolitem.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolitem.sgml
@@ -281,3 +281,11 @@ accessed through the functions described below.
 @menu_item: 
 
 
+<!-- ##### FUNCTION gtk_tool_item_rebuild_menu ##### -->
+<para>
+
+</para>
+
+@tool_item: 
+
+

diff --git a/docs/reference/gtk/visual_index.xml b/docs/reference/gtk/visual_index.xml
index 7d9dd3978246c66c6f2f8e5d00bf24df06364c51..951c7f2424b054d0160f4312266763a3bb6baca3 100644 (file)
--- a/docs/reference/gtk/visual_index.xml
+++ b/docs/reference/gtk/visual_index.xml
@@ -17,7 +17,7 @@
   <link linkend="GtkEntry">
     <inlinegraphic fileref="entry.png" format="PNG"></inlinegraphic>
   </link>
-  <link linkend="gtk-GtkFileChooserButton">
+  <link linkend="GtkFileChooserButton">
     <inlinegraphic fileref="file-button.png" format="PNG"></inlinegraphic>
   </link>
   <link linkend="GtkFontButton">

diff --git a/docs/tools/widgets.c b/docs/tools/widgets.c
index cff1b15c979f6c87d2d11f4d71875e240a891f37..12d7d188fe9f29378e3b18506051af8fdc561a46 100644 (file)
--- a/docs/tools/widgets.c
+++ b/docs/tools/widgets.c
@@ -327,21 +327,44 @@ static WidgetInfo *
 create_file_button (void)
 {
   GtkWidget *vbox;
+  GtkWidget *vbox2;
   GtkWidget *picker;
   GtkWidget *align;
 
-  vbox = gtk_vbox_new (FALSE, 3);
+  vbox = gtk_vbox_new (FALSE, 12);
+  vbox2 = gtk_vbox_new (FALSE, 3);
   align = gtk_alignment_new (0.5, 0.5, 0.0, 0.0);
-  picker = gtk_file_chooser_button_new ("File Button");
+  picker = gtk_file_chooser_button_new ("File Chooser Button");
   gtk_widget_set_size_request (picker, 150, -1);
   gtk_file_chooser_set_filename (GTK_FILE_CHOOSER (picker), "/etc/yum.conf");
   gtk_container_add (GTK_CONTAINER (align), picker);
-  gtk_box_pack_start (GTK_BOX (vbox), align, FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox2), align, FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox2),
+                     gtk_label_new ("File Button (Open)"),
+                     FALSE, FALSE, 0);
+
   gtk_box_pack_start (GTK_BOX (vbox),
-                     gtk_label_new ("File Button"),
+                     vbox2, TRUE, TRUE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+                     gtk_hseparator_new (),
                      FALSE, FALSE, 0);
 
-  return new_widget_info ("file-button", vbox, SMALL);
+  vbox2 = gtk_vbox_new (FALSE, 3);
+  align = gtk_alignment_new (0.5, 0.5, 0.0, 0.0);
+  picker = gtk_file_chooser_button_new ("File Chooser Button");
+  gtk_file_chooser_set_action (GTK_FILE_CHOOSER (picker),
+                              GTK_FILE_CHOOSER_ACTION_SAVE);
+  gtk_widget_set_size_request (picker, 150, -1);
+  gtk_file_chooser_set_filename (GTK_FILE_CHOOSER (picker), "/etc/yum.conf");
+  gtk_container_add (GTK_CONTAINER (align), picker);
+  gtk_box_pack_start (GTK_BOX (vbox2), align, FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox2),
+                     gtk_label_new ("File Button (Save)"),
+                     FALSE, FALSE, 0);
+  gtk_box_pack_start (GTK_BOX (vbox),
+                     vbox2, TRUE, TRUE, 0);
+
+  return new_widget_info ("file-button", vbox, MEDIUM);
 }
 
 static WidgetInfo *